OLA 文档中心

主题

2026-07-14

申请试用 - Trial ​

函数简介 ​

向欧拉授权平台申请试用授权，无需激活码。返回 JSON 的字段含义与结构同 激活 - Activate。

返回数据格式：

json
{
  "EndTime": "2026-03-01 11:40:41.193",
  "LicenseType": 3,
  "LicenseTypeStr": "月卡",
  "Message": "",
  "RemainingCount": 0,
  "ServerTime": "2025-12-30 11:40:41.132",
  "Status": 0,
}
字段名说明
EndTime授权到期时间。
LicenseType授权类型：0次卡，1小时卡，2日卡，3月卡，4年卡，5永久卡。
LicenseTypeStr授权类型描述。
Message提示信息；失败时多为 错误码:中文描述（如 "2003:参数无效"），也可直接展示给用户。完整对照见 客户端错误码说明。
RemainingCount次卡剩余次数。
ServerTime服务器时间。
Status激活状态：1成功，0失败。

常见错误码（Message 字段） ​

格式：{错误码}:{中文描述}。

Message含义
2002:用户码无效用户码无效
2003:参数无效入参校验失败
2004:用户不存在用户不存在
2005:软件不可用或未开通SoftCode 无效或未开通
2008:授权无效试用后授权状态异常
2099:…试用申请失败（冒号后可能为下游具体原因，如次数用尽）

接口名称 ​

Trial

DLL调用 ​

long Trial(string userCode, string softCode, string softVersion, string dealerCode);

参数说明 ​

参数名类型说明
userCode字符串用户码。
softCode字符串软件码。
softVersion字符串软件版本。(用于区分你自己的软件版本信息,未来可用于版本控制,可空)。
dealerCode字符串经销商码。(用于区分你自己的经销商信息,未来可用于版本控制,可空)。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
OlaAuthTrialReturn result = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode");
// result.Status == 1 表示试用成功
csharp
using OLAPlug;

var ola = new OLAPlugServer();
OlaAuthTrialReturn result = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode");
// result.Status == 1 表示试用成功
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
json_result = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode")
# Python SDK 返回 JSON 字符串，需自行解析
java
import com.olaplug.OLAPlugServer;
import com.olaplug.model.OlaAuthTrialReturn;

OLAPlugServer ola = new OLAPlugServer();
OlaAuthTrialReturn result = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode");
// result.Status == 1 表示试用成功
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
result := ola.Trial("userCode", "softCode", "1.0.0", "dealerCode")
// result.Status == 1 表示试用成功
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let result = ola.trial("userCode", "softCode", "1.0.0", "dealerCode");
// result.status == 1 表示试用成功
cpp
var ola = com("OlaPlug.OlaSoft")
var result = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode")
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
Set result = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode")
text
.局部变量 ola, OLAPlug
.局部变量 result, OlaAuthTrialReturn
ola.创建 ()
result ＝ ola.Trial(“userCode”, “softCode”, “1.0.0”, “dealerCode”)
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var json = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode");
// Aardio SDK 返回 JSON 字符串，需自行解析
text
变量 ola <类型 = OLAPlugServer>
变量 result <类型 = OlaAuthTrialReturn>
ola = 新建 OLAPlugServer
result = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode")
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
OlaAuthTrialReturn result = ola.Trial("userCode", "softCode", "1.0.0", "dealerCode");
// result.Status == 1 表示试用成功

原生 DLL 调用 ​

cpp
Trial(instance, "userCode", "softCode", "1.0.0", "dealerCode");
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long Trial(string userCode, string softCode, string softVersion, string dealerCode);

Trial(instance, "userCode", "softCode", "1.0.0", "dealerCode");
python
from ctypes import CDLL, c_int, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
ola.Trial(instance, "userCode", "softCode", "1.0.0", "dealerCode")

返回值 ​

调用方式返回值说明
SDKOlaAuthTrialReturn结构化返回对象；Status == 1 表示试用成功
原生 DLL非 0成功，返回 JSON 字符串格式的结果。
原生 DLL0失败。

注意事项 ​

项目说明
释放内存返回的字符串指针需要调用 FreeStringPtr 接口释放内存。
用户码、软件码、软件版本与经销商码需与欧拉后台中用户码、软件码、软件版本与经销商码需与欧拉后台中该软件/试用策略的配置一致。
试用次数、时长、是否允许重复申请等以 **授权平试用次数、时长、是否允许重复申请等以 授权平台当前策略 为准；失败时请关注 Message 字段说明。
错误提示本接口业务失败 Message 为 错误码:中文描述；完整码表见 客户端错误码说明。